home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Libris Britannia 4
/
science library(b).zip
/
science library(b)
/
COMMUNIC
/
BULLETIN
/
0818B.ZIP
/
TPB-CMDS.MAN
< prev
next >
Wrap
Text File
|
1987-12-01
|
26KB
|
621 lines
System SysOps Commands Manual
for
TP-Board Version 2.0
Copyright (c) 1987 by Jon E. Schneider
=================================================================
TP-Board is based on the Pascal Integrated Communications System
(PICS), Copyright 1986, 1987 by Les Archambault. This software is
being distributed with his knowledge and consent. A large portion
of the TP-Board code is an exact duplicate of the PICS code.
=================================================================
This manual covers the TP-Board commands that are NOT
covered in the Users Guide and are only available to the Sysop
and his assistants (access level >=250). It is assumed that you've
already read the installation guide, and have an operating TP-
Board system.
While the system is waiting for a call, the screen will be
cleared and the cursor randomly repositioned every few seconds.
If the system is re-cycling from a caller logoff and the
space left on disk is less than the amount set, the local Sysop
console will display a message approximately every five times the
cursor moves. It will detail the disk space problem and stay on
the screen for about 6 seconds. This indicates that the Sysop
should take whatever action is necessary to make more disk space
available.
If you are using SEAdog as the BBS's front end, then these
features obviously will not be available, since the only time
that TP-Board is running is when there is a caller present.
IDLING (WAITING FOR CALL) COMMANDS
If you desire, you may get a system status report by
entering a RETURN at the local console. TP-Board will display an
abbreviated system status message, and will show you the other
two possible commands on the status line. The other two commands
are Control C for exiting TP-Board, and Control L for local Sysop
use.
This message will stay on the console screen for about 25 seconds.
SYSTEM IN USE NOTES
While the system is in use by a caller, the following in use
commands are available to the Sysop (^ means control character):
^J Display menu of console commands on the status
line.
^W: Sysop initiated CHAT
^E: Blank out remote caller screen, on/off
^R: Grab system for local use after caller logs
off.
^T: Twit
^W Sysop initiated CHAT. The current user is issued a message
and the system enters the chat mode. This command bypasses
the time of day checks and may be entered at any time (chat
hours are restricted to callers requesting chat).
^E 'Blank' remote screen. Toggle output to remote system.
Useful to help a lost user find a file or message. May
also be used to validate a remote user since the access
level is temporarily set to SYSOP level and then reset when
remote I/O is reinstated.
^R 'Delayed' shutdown. When the current user logs out, the
modem is made busy and the system rings the bell to
indicate that it is available. Until the operation actually
takes place, this key may be used to alternately turn the
function on and off. If the sysop doesn't take action to take
over the system in a reasonable period of time, the system
will put itself back online waiting for calls.
^T 'Twit' key. Immediately hang up on remote user. The
previous command is preferred to gain system access, but
sometimes this command is necessary.
MESSAGE READING SYSOP COMMANDS
While reading messages and at the Read <Y><N><C><Q><P><R>
prompt there are two Sysop Commands available, <X> and <V>. These
commands are NOT available while in any of the FidoNet areas.
E<X>tended Sysop Commands
This command acts on the current message being read
and will show you a new prompt:
Sysop Message Command <D><H><I><M><N><P><R><Q><?>
<D>elete message - marks message deleted.
<H>ide Message - Marks message as Restricted and
therefore invisible until Sysop releases it.
<I>ndividual - Marks message as Private.
<M>ove - Lets you change the message area.
<N>o Purge - Toggles the protection from purging
and notifies you of the status.
<P>ublic - Marks the message as Public.
<R>ead - Marks the message as having been read.
<Q>uit this command.
<V>alidate Caller
With this command you are able to validate the
caller who left the current message being read.
The callers log-in information will be displayed
and you will be able to edit any of the users
parameters.
<S>ave Message to Disk File
This command will save the current message being
read to a disk file in the System File Section. You
will be prompted for the filename to use for the file.
If it already exists, you will be asked is you want to
use it anyway. After recording the message (and
header) you will be returned to reading messages.
After either of these commands are used, you are returned to
the message reading commands and can continue reading the next
message.
FILES SUB-SYSTEM SYSOP COMMANDS
The following commands are only available to the sysop and
assistants, even though they are located in the Files subsystem.
The command prompts will be displayed only if the current user
access level >=250.
COPY - This command is used to copy a file from the current
File Section to another File Section. When the copy is
completed successfully, the system will ask if the source
file should be deleted.
DELETE - This command is used to delete any file from the
currently logged File Section. Verification is requested
before the action takes place.
RENAME - Allows renaming of any file in the current File
Section.
STAT - Shows the status: (visible/invisible) of the named file
in the current File area and asks if you want to reverse the
status.
UTILITIES SYSOP COMMANDS
<D>isplay Users - You are given the choice of several kinds
of lists from the following menu. If current user access
is less than 250 the <B>rief list is automatic.
Type of List <A><B><E><Q><U><?>
<A>ll - A complete list of all users and all information
in each user record is displayed.
<B>rief - This is the same list shown to regular callers.
It shows the callers name, city, type of computer,
and the last date they called the system.
<E>xceptional - Users having access higher than the
default value or greater time allowed on
the system are displayed.
<U>nvalidated - Unvalidated Users are displayed.
<C>hat - The Sysop answers a chat request with the Escape key.
Either party can exit the chat with a Control C character.
<T>ime - After displaying the information you will be asked
if you want to change the time. If you do, you will be
prompted for year, month, day, hour, minute, and
second (one at a time). It is expecting up to 2 numeric
digits as a reply.
SYSOP SUB-SYSTEM COMMANDS
-------------------------
The sysop sub-system command menu is accessed by typing "X"
at any function prompt (this option is locked out to users below
access level 250). The sysop menu may be displayed by entering
"?" (see sample partial menu below).
The user, log, and message files may be displayed on the CRT
or printed to the LST device based on the condition of the print
toggle. In addition, the Audit file command can be used to write
the LOG or Message files to a disk ASCII text file.
Sysop Sub-System Partial Menu
-----------------------------
<A>udit trail toggle <O> Macro operations
<B>uild Message <P>urge files
<C>hange System parameters <R>ead Messages
<D>elete user <S>ystem Directory
<E>dit user <T>oggle printer
<I>ndex rebuild <V>alidate User
<L>og file list <X> Exit to DOS
<N>ewin file processing
<G>oodbye (logoff)
AUDIT COMMAND
-------------
A standard ASCII text file can be created from the log and
message files (excluding the FidoNet areas) by turning on an
audit trail and using the 'L' and 'R' sysop commands.
The system will show you the default File Section where the
Audit File will be written and ask if you want to make a change.
The created file consists of the system date as file name with a
numeric extension starting with zero.
For example, the first time the audit trail is enabled on
the 15th of August 1985, the name would be 08-15-85.000. If the
audit trail were turned off and on later in the same day, the
file name would be 08-15-85.001.
BUILD MESSAGE COMMAND
---------------------
With this command you are able to build a message (in the
message base) from a disk file (ASCII text file only). The file
to be used must be in the System File Section.
You will be prompted for the header information and then the
name of the file to be used as the body of the message.
CHANGE SYSTEM PARAMETERS COMMAND
--------------------------------
The default settings that are shown here take effect when
TP-Board is entered and remain in effect until changed. See the
installation manual for a complete description of these settings.
You will be asked if you wish to change the SYSTEM, PURGE, or
FIDO settings. This division of the settings is for screen
display convenience only.
DELETE USER COMMAND
-------------------
The sysop is asked for a name to be deleted from the user
file. TP-Board prompts to insure that this is the action desired
and if so, deletes the user and any messages addressed to or from
that user. The 'NEWIN' list is searched for any files uploaded
from that user, and if any are found, the uploaders name field is
changed to 'Unknown'.
EDIT USER COMMAND
-----------------
The record of the selected user is displayed and you are
given the option of changing any field except the users name.
This is because the users first and last names are used as the
key to this record. The time of last access is also unchangeable.
You will be prompted for the number of the item that you want to
change.
In all other cases which require the user name, TP-Board
expects an exact match between the characters entered and the
name in the file. In this command (Edit User), TP-Board is
somewhat more forgiving and will find the record which is equal
to OR GREATER THAN the entered name.
For example, if you cannot remember how John Smith spells
his last name, enter 'John Smith' and TP-Board will find the
record even if John spells his last name 'Smithe.' The drawback
to this of course, is that it is possible to get the wrong user
record if two names are very similar, so be very careful that you
have the expected record before editing.
Note:
It is in this command that you are able to change the user
record flag bits that control each user's privileges and
authorization to enter conferences.
There are seven possible conferences, but don't set any flags
above the maximum number you are using, as that would give the
user access to possible future conferences.
There are currently five active user privilege flags:
Allow downloading files
Allow entering of private messages
Allow entering of public messages
Allow entering any messages
Exempt user from User File purges.
When a new user record is created, the user is not granted
authorization for any conferences. The first four privilege
flags are set to allow the indicated actions, and the user is
not exempt from a User file purge.
INDEX REBUILD COMMAND
---------------------
If you suspect that either the user file or its index may be
damaged, this command may be used to rebuild the index file and
recover from certain types of damage to the user data file. File
damage should never occur during normal operation, but power
fluctuations and faulty disks and drives can cause problems.
During execution of this command, the record number, a
linked list element, and the user names are displayed. For more
information about the structure of data files when using the
Turbo Toolbox, refer to the Turbo Toolbox Reference Manual (c)
Borland International.
LOG FILE LIST COMMAND
---------------------
TP-Board maintains a time and date stamped list of most
system operations. This command will display this list. From the
information contained in this file, the sysop can determine what
kind of activity the system is being used for, what users seem to
be having problems, what users are abusing their privileges, etc.
If audit file generation is turned on, the log information
will be written to this file.
NEWIN FILE PROCESSING COMMAND
-----------------------------
TP-Board marks all uploads with the system attribute bit
(making them invisible) to prevent directory display, and stores
a one line description of the file. This command allows the sysop
to release the file and description for access by normal users,
hide the file and description from normal users, delete the
description (not the file itself), edit the description. Until
the file is purged (see Purge), all entries may be freely edited
by the sysop.
For example, when a user uploads a file, TP-Board will mark
the file as hidden until the sysop has a chance to review the
contents of that file. If appropriate, the sysop can release the
file (making it visible in the File Section directory) for users.
At that time, not only will the file be available in the
NEWIN section (or section where the Sysop has moved it) for
downloading, but the description entered at upload time can be
seen by other users using the Newin command at the files sub-
system menu.
In addition to the file name and description, TP-Board
displays the name of the individual that performed the upload and
the time and date the operation was completed.
<O> MACRO OPERATIONS COMMAND
----------------------------
In addition to being able to read characters from either the
keyboard or the remote channel, TP-Board can read from an
internal character string called a macro.
This string can be used to execute any sequence of
operations as defined by the sysop. The macro string is fed into
the multiple command buffer for execution so be sure that it is a
completely executable set of commands.
Macro operations may be performed while the system is being
used by the Sysop, or from the automatic macro operation switch
setting where the system logs the Sysop in and performs the macro
string even though there is no one at the local console.
For example, the sequence 'T;Y;U;U;A;^M;X;L;R;P;A;Y;T' performs
the following operations:
Toggle the printer on T
Yes, really do it Y
Utility sub-system entry U
User file listing of ... U
All users A
No starting name specified ^M (carriage return)
Re-enter the sysop sub-system X
List the log file L
Read the messages R
Purge ... P
All files A
Yes, really do it Y
Toggle the printer back off T
Remember if you have the auto macro processing switch turned
on so that the macro will execute by itself every day, the last
command in the macro MUST be a G so that the system will
terminate the macro and go back online waiting for callers.
(During the auto macro execution, the system thinks the sysop is
using the system locally.)
This type of operation is typical of that performed during
the regular maintenance of the TP-Board files and can take some
time to complete. The ability to perform these operations
unattended can be very convenient.
Three commands are available to control the macro operation:
Display the contents of the macro buffer
Edit the macro string (editing commands are described in
the User's Guide)
Start the macro
TP-Board is still monitoring both the local keyboard while
processing a macro, so the sysop can pause (^S) or cancel (^C) a
command, but macro processing will continue until complete.
Since a carriage return is used to terminate the entry of a
new macro string, a slash (/) may be entered into the macro.
When encountered, TP-Board will convert this character into a
carriage return.
PURGE FILES COMMAND
-------------------
This command purges and compresses system data files of
deleted entries. It processes four different files, each
selectable by a single command, or all four files together.
All commands are verified before continuing.
Sufficient disk space must be available for these operations
or TP-Board will report an error and terminate. Should this
happen, TP-Board will automatically recover from the old files
the next time it is started, but extraneous files may be left on
the disk.
Purge All - This command purges all four files, i.e. it
automatically performs a purge of the log, newin, user, and
messages files.
Purge Log - This command removes all entries from the log
file.
Purge Newin - This command removes all entries marked
"deleted" in the newin file.
Purge Messages - As described in the introduction, deleting
a message only marks that message for delete. To physically
remove the message from the disk, the message files must be
purged.
Purge Users - This command deletes all users that have not
logged in within the times specified at compile time. When
a user is deleted with this command, TP-Board will also delete
any messages sent to or from the user.
READ MESSAGES COMMAND
---------------------
All messages currently on file are displayed in numerical
order. If the audit trail is on, these messages are also written
to that file.
SYSTEM DIRECTORY COMMAND
------------------------
A directory of all files in sections with access levels of
20 or less is built in the LOGIN section. This directory can be
used by remote users to speed file download operations.
TOGGLE PRINTER COMMAND
----------------------
The currently assigned LST device is alternately enabled and
disabled. To prevent possible toggling while remote, this
command is verified before continuing.
VALIDATE USER COMMAND
---------------------
This command allows the sysop to validate a user from the
Sysop sub-system menu instead of going into the message file. It
is most helpful when you know the name of the user that you want
to validate.
NOTE:
The validate and delete commands will only operate on users of a
lower access level. The edit command will operate on users of
the same or lower access level.
This access level structure allows the primary sysop to
affect all user records in the system, including his own, but
alternate sysops can neither affect nor view the record of the
primary sysop. In addition, since the validate and delete
commands only operate on users of a lower access level, the
hazard of validating or deleting oneself has been reduced.
CAUTION:
Since the primary sysop can edit any user record, please
exercise care not to lower your own access level! The only known
recovery from this action (if there are no other sysops at the
255 level) would be to use a file zap utility such as PATCH.COM.
EXIT TO DOS COMMAND
-------------------
This command is very handy when you are working at the local
console, and very dangerous when you are operating remotely. It
allows temporarily exiting TP-Board to DOS, and then returning to
TP-Board without actually having to log-off and then back on. It
is most useful for copying files from directories that TP-Board
doesn't recognize to ones that it does.
TP-Board will invoke another copy of COMMAND.COM, and then
pass control to it. Once you are finished, and want to return to
TP-Board, just type 'EXIT' at the DOS prompt.
If you always return immediately to TP-Board when attempting
to 'Shell to DOS', then you don't have your DOS path set
properly. A copy of COMMAND.COM has to reside either in the path
that is active when TP-Board is running, or in the TP-Board
system directory.
If you do not want to have the remote ability activated,
just delete the file REMOTE.BAT from the system directory. It is
covered in more detail in the installation manual.